home *** CD-ROM | disk | FTP | other *** search
ssssttttrrrrppppttttiiiimmmmeeee((((3333CCCC)))) ssssttttrrrrppppttttiiiimmmmeeee((((3333CCCC)))) NNNNAAAAMMMMEEEE _ssss_tttt_rrrr_pppp_tttt_iiii_mmmm_eeee - date and time conversion SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_mmmm_eeee_...._hhhh_>>>> _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_pppp_tttt_iiii_mmmm_eeee _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_bbbb_uuuu_ffff_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt_mmmm _****_tttt_mmmm_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _ssss_tttt_rrrr_pppp_tttt_iiii_mmmm_eeee converts the character string pointed to by _b_u_f to values which are stored in the ttttmmmm structure pointed to by _t_m, using the format specified by _f_o_r_m_a_t. The _f_o_r_m_a_t string consists of zero or more directives and ordinary characters. Each directive is composed of one of the following: one or more white-space characters (as specified by _i_s_s_p_a_c_e(); an ordinary character (neither % nor a white-space character); or a conversion specification. Each conversion specification is composed of a % character followed by a conversion character which specifies the replacement required. There must be white-space or other non-alphanumeric characters between any two conversion specifications. The following conversion specifications are supported: _%%%%_%%%% same as % _%%%%_aaaa is the day of week, using the locale's weekday names; either the abbreviated or full name may be specified. _%%%%_AAAA is the same as %a. _%%%%_bbbb is the month, using the locale's month names; either the abbreviated or full name may be specified. _%%%%_BBBB is the same as %b. _%%%%_cccc is replaced by the locale's appropriate date and time representation. _%%%%_CCCC is the century number [0,99]; leading zeros are permitted but not required. _%%%%_dddd day of month ( 01 - 31 ); leading zeroes are permitted but not required. _%%%%_DDDD date as _%%%%_mmmm_////_%%%%_dddd_////_%%%%_yyyy _%%%%_eeee is the same as %d. _%%%%_hhhh is the same as %b. _%%%%_HHHH is the hour (24-hour clock) ( 00 - 23 ); leading zeroes are permitted but not required. _%%%%_IIII hour ( 01 - 12 ) _%%%%_jjjj day number of year ( 001 - 366 ) _%%%%_mmmm month number ( 01 - 12 ) _%%%%_MMMM minute ( 00 - 59 ) _%%%%_nnnn is any white space. _%%%%_pppp locale's equivalent of either AM or PM _%%%%_rrrr time as _%%%%_IIII_::::_%%%%_MMMM_::::_%%%%_SSSS _%%%%_pppp [_AAAA_MMMM|_PPPP_MMMM] _%%%%_RRRR time as _%%%%_HHHH_::::_%%%%_MMMM _%%%%_SSSS seconds ( 00 - 61 ), allows for leap seconds PPPPaaaaggggeeee 1111 ssssttttrrrrppppttttiiiimmmmeeee((((3333CCCC)))) ssssttttrrrrppppttttiiiimmmmeeee((((3333CCCC)))) _%%%%_tttt is any white space. _%%%%_TTTT time as _%%%%_HHHH_::::_%%%%_MMMM_::::_%%%%_SSSS _%%%%_UUUU week number of year ( 00 - 53 ), Sunday is the first day of week 1 _%%%%_wwww weekday number ( 0 - 6 ), Sunday = 0 _%%%%_WWWW week number of year ( 00 - 53 ), Monday is the first day of week 1 _%%%%_xxxx locale's appropriate date representation _%%%%_XXXX locale's appropriate time representation _%%%%_yyyy year within century ( 00 - 99 ) _%%%%_YYYY year as ccyy ( e.g. 1986) The difference between _%%%%_UUUU and _%%%%_WWWW lies in which day is counted as the first of the week. Week number 01 is the first week in January starting with a Sunday for _%%%%_UUUU or a Monday for _%%%%_WWWW. Week number 00 contains those days before the first Sunday or Monday in January for _%%%%_UUUU and _%%%%_WWWW, respectively. SSSSeeeelllleeeeccccttttiiiinnnngggg tttthhhheeee OOOOuuuuttttppppuuuutttt''''ssss LLLLaaaannnngggguuuuaaaaggggeeee By default, the output of _ssss_tttt_rrrr_pppp_tttt_iiii_mmmm_eeee appears in U.S. English. The user can request that the output of _ssss_tttt_rrrr_pppp_tttt_iiii_mmmm_eeee be in a specific language by setting the _l_o_c_a_l_e for _c_a_t_e_g_o_r_y _LLLL_CCCC______TTTT_IIII_MMMM_EEEE in _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee. TTTTiiiimmmmeeeezzzzoooonnnneeee The timezone is taken from the environment variable _TTTT_ZZZZ [see _cccc_tttt_iiii_mmmm_eeee(3C) for a description of _TTTT_ZZZZ]. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE Upon successful completion, _ssss_tttt_rrrr_pppp_tttt_iiii_mmmm_eeee_((((_)))) returns a pointer to the character following the last character parsed. Otherwise, a null pointer is returned. FFFFIIIILLLLEEEESSSS _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______TTTT_IIII_MMMM_EEEE - file containing locale-specific date and time information SSSSEEEEEEEE AAAALLLLSSSSOOOO _tttt_iiii_mmmm_eeee_((((_2222_)))), _cccc_tttt_iiii_mmmm_eeee(3C), _ssss_tttt_rrrr_ffff_tttt_iiii_mmmm_eeee(3C), _gggg_eeee_tttt_eeee_nnnn_vvvv(3C), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C), _tttt_iiii_mmmm_eeee_zzzz_oooo_nnnn_eeee(4), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5). PPPPaaaaggggeeee 2222 
